MovieClip.hitTest()

Доступность

Flash Player 5.

Синтаксис

my_mc.hitTest(x:Number, y:Number, shapeFlag:Boolean) : Boolean
my_mc.hitTest(target:Object) : Boolean

Параметры

x Координата x на Сцене.

y Координата y на Сцене.

Координаты x и y определены в глобальной системе координат.

target Путь к объекту, на пересечение которого с мувиклипом my_mc происходит проверка. Параметр target обычно представляет из себя мувиклип, кнопку или текстовое поле.

shapeFlag Булева величина, определяющая происходит ли проверка пересечения контура фигуры (true) или ограничивающей рамки (bounding box) (false). Этот параметр может быть задан только в случае задания параметров x и y.

Возвращает

Булева величина, true, если my_mc пересекается с определенной зоной (или накрывает указанную точку) и false в противном случае.

Описание

Метод; проверяет, накрывает ли my_mc указанную точку с координатами x and y или пересекается с указанным объектом target.

Синтаксис 1: проверяет точку с координатами x и y на принадлежность фигуре или ограничивающей рамке объекта, в зависимости от параметра shapeFlag. Если shapeFlag имеет значение true, проверяется лишь область Сцены, реально накрываемая объектом, и если точка с координатами x и y попадает в эту область, возвращается true. Это полезно при определении, находится ли мувиклип в определенной точке.

Синтаксис 2: проверяет факт пересечения ограничивающих рамок объекта target и указанного мувиклипа, возвращая true, если они имеют хотя бы одну общую точку.

Пример

В примере ниже используется hitTest() для определения, пересекаются ли мувиклипы circle_mc и square_mc, когда пользователь отпускает кнопку мыши:

square_mc.onPress = function() {
  this.startDrag();
};
square_mc.onRelease = function() {
  this.stopDrag();
  if (this.hitTest(circle_mc)) {
    trace("Пересечение с кругом!");
  }
};

См. также

MovieClip.getBounds(), MovieClip.globalToLocal(), MovieClip.localToGlobal()

Посмотреть комментарии LiveDocs

Предыдущая | Следующая | Оглавление